Repository navigation
Conversation
…nd Dark Forces cores
The cores esp-box-emu moved to submodules (each repo holds the core plus
its port/ glue, written against BoxEmu, which the Tab5 aliases to
Tab5Emu), added the same way as the Genesis and PICO-8 ones:
- components/{nes,gbc,sms,msx,doom,darkforces}: the submodules plus their
component CMake from the box, with the static state (.bss and .data)
moved to PSRAM by tools/bss_to_psram.py (the P4 has no extern_ram
placeholder for ldgen). fMSX and gnuboy define globals that snes9x, MGS,
the Genesis core and the TPM runtime also define; those are renamed in
their libraries with objcopy --redefine-syms.
- main/: the carts, ported from the box, with the Tab5's video settings
(original = integer scale, fit, fill).
- rom_info: the new platforms (.nes, .gb, .gbc, .sms, .gg, .rom, .wad,
DARK.GOB) and consoles (NES, Game Boy, Game Boy Color, Master System,
Game Gear, MSX), in the box's order and colors.
- Tab5Emu: make_color(), osd_getromdata(), no-op haptics, and
reserve_romdata(): MSX, Doom and Dark Forces run their allocator in the
box's fixed 4 MB ROM block, which the Tab5 allocates per cart.
- pool_allocator from the box (JK's private pool functions are renamed
jk_pool_* so they don't collide with it).
The core repos needed three RISC-V build fixes (fix/riscv-build in
esp-cpp/gnuboy, nofrendo and TheForceEngine): Xtensa-only inline asm and
an Xtensa-only ESP-IDF backtrace call.
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
The NES ran at ~30 fps: the glue made 1600 audio samples a frame instead of 367, and the Tab5 paces to the DAC. Measured after the fix: ~3 ms of emulation per frame, 60 emulated / ~30 presented fps (nofrendo's frame skip). Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
- components/scummvm: esp-cpp/scummvm (branch esp32p4) as a submodule, with the ESP32 backend in backends/platform/esp32; built with the startrek engine only, no RTTI and no ScummVM GUI (~1.1 MB of flash). - A game is a marker file *.scummvm in the game's folder (Emulator::SCUMMVM, shown under PC); ScummVM detects which game the folder holds. - ScummvmCart: the engine runs in its own task; the pause menu parks it and saves / loads through the engine's save states into the slot files; the 4:3 games' 320x200 is shown at 4:3. Touch is the mouse (two fingers = right click), as are a USB mouse and the gamepad (A / B = left / right click). - Tab5Emu::display_size() getter (touch -> game coordinates). - CI: checks out the new core submodules (ScummVM shallow). Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
- esp-cpp/scummvm esp32p4 66a0f24: the backend's quit / load / task fixes and the startrek engine's save states and teardown fixes. - The component renames ScummVM's allocation functions to the backend's PSRAM ones (backends/platform/esp32/psram_alloc.syms). Tested on the Tab5 with the 25th Anniversary Enhanced CD (English + speech): intro, bridge and briefings; pause-menu save (while the game waits for input) and load (restarts the game with the state, from anywhere); repeated launches and quits, including during the intro. Known: each engine instance leaves ~90 KB of PSRAM behind (the engine's own teardown), until the next boot. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
…tion - esp-cpp/scummvm esp32p4 7c81792: three startrek engine leaks fixed (LZSS input streams, the bridge's ever-growing action queue, the save thumbnail) and the backend's detection data left on a jumped-over stack. - idf.py -DSCUMMVM_TRACK_ALLOCS=1 build: tracks ScummVM's allocations and writes what each run leaves to /sdcard/saves/scummvm_leaks.txt. Measured on the Tab5: free PSRAM flat during bridge play (was -600 B/s), and a few hundred bytes a game run (was 50-130 KB). Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
…oom's crash - Dark Forces: its free() wrapper kept claiming its ended session's 4 MB block, which the Tab5 gives back to the heap with the cart: every free() the other games later made into that range was swallowed, and Jedi Knight hung for want of memory. The cart now calls darkforces_forget_block() (TheForceEngine 03417ff) before the block goes. - ScummVM (esp-cpp/scummvm a0a35c3): a game runs in its own PSRAM arena, given back whole at its end, and the long-lived set-up is done at boot (scummvm_prepare() in main): Star Trek no longer leaves blocks mid-heap that split the big ones Jedi Knight wants. - Tab5Emu::play_audio()'s 30 s report is debug-level: it is formatted on the game's audio task, and Doom's 2 KB one overflowed (a stack protection fault after 30 s of play). Checked on the Tab5: Doom (60+ s), Dark Forces, Star Trek, then Jedi Knight (20 fps), MGS, TPM, GBA, Genesis, PICO-8, NES, GB/GBC, SMS/GG, MSX. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
…d fails late) Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
…-op here) Built without exceptions (ESP-IDF), libstdc++'s vector::shrink_to_fit() does nothing: Jedi Knight's presentation buffers (~1.8 MB: the RGB565 frame, two 8-bit frames, two overlays) and TPM's copy of the game executable stayed allocated after the game. With ~1.35 MB less PSRAM since the new cores and ScummVM, the SNES core then had too little left after Jedi Knight. They are swapped with empty vectors now. Checked on the Tab5: free PSRAM after quitting Jedi Knight is back to what it was before (7.28 MB, largest block 7.17 MB); JK -> SNES -> TPM -> SNES -> JK all run. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
Bumps the esp-cpp/scummvm fork: config defaults registered (speech and effects played at volume 0 once the engine synced its settings), repeated log lines counted (the per-row drawR3Shape warning stalled the intro), close shapes drawn and shapes behind the camera culled (the intro's planet). Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
Bumps the esp-cpp/scummvm fork to the reverse-engineered ship rendering (views picked by angle, the original's 2D transform, dithered close-ups), the view check and draw order, and the intro's movement, credits and captions as the original plays them. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
Bumps the esp-cpp/scummvm fork: the bridge's viewscreen shows space, the star systems' planets (generated as the original does), entering and leaving orbit and the mission start fly-bys as the original plays them. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
…is known The ScummVM cart applied fit/original before the engine had set up its screen (0x0 then, ScummVM being prepared at boot), so a game started filling the screen until the pause menu re-applied it. It now follows the screen's size whenever that changes. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
Bumps the fork: ships fly and fight as the original's, the captain flies and fires from the viewscreen (tap: phasers, two fingers: torpedoes), and the missions' bridge scripts with their battles. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
…orces' mouse The link's test control gets TOUCH (protocol 5): a finger at (x, y), held for a time or until the next TOUCH, in the screen's pixels or (flag 0x80) the screenshot's, which the firmware maps through the frame's place on the screen. The finger counts as a touch everywhere: touchpad_data() (ScummVM), the touch virtual gamepad and its menu hot corner, and the launcher's LVGL menus (a pointer input device of its own). emulink: tap, touch (hold / lift) and drag, --frame for screenshot pixels. The web console's screen is a touch screen: click or drag on it. Tab5Emu::touch_pointer() / screen_to_frame() give games a pointer that can skip the touch gamepad's zones; Dark Forces (TheForceEngine feat/touch-mouse) uses them: in the menus the finger is the cursor, in a mission a drag off the touch gamepad is mouse look and a quick tap fires. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
LVGL rotates what a pointer input device reads (the BSP's touch is the panel's portrait coordinates), so the link's finger, in landscape, landed elsewhere: rotate it back first. Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
finger563
marked this pull request as ready for review
November 16, 2026 00:35
…ariablePointer) Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
components/devlink, main/remote_control.hpp, tools/emulink and web/ were the same in esp-box-emu and tab5-emu; they are esp-cpp/emulink now, a submodule at components/emulink (the `emulink` component: DevLink and the header-only RemoteControl). tools/emulink and web are links into it, so `cd tools/emulink && python -m emulink` and the local web server work as before; the pages workflow publishes components/emulink/web. The board component comes from EMULINK_BOARD_COMPONENT (box-emu by default). Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
# Conflicts: # .gitmodules # CMakeLists.txt # components/darkforces/TheForceEngine
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Also includes #25, merged into this branch: the USB link (devlink, the test control, emulink, the web console) moves to the shared esp-cpp/emulink submodule at
components/emulink. It also includes a cppcheck fix: thecartpointer in TOUCH's frame mapping is now pointer-to-const.Stacked on #23, which is merged; the PR now targets main. The same change for esp-box-emu is in its own PR.
Touch over the USB link
TOUCH(0x0F):u8 fingers, u16 x, u16 y, u16 hold_ms. A finger is held forhold_msand then lifted, or with 0 it stays down until the nextTOUCH, so a drag is a run of them.fingers = 0lifts it. The coordinates are screen pixels (1280×720). With flag0x80they are screenshot pixels instead; the firmware maps them through the frame's place on the screen.touchpad_data()(ScummVM), the touch virtual gamepad and its menu hot corner, and the launcher's LVGL menus, which get a pointer input device of their own.emulink tap X Y,emulink touch X Y/emulink touch(hold / lift),emulink drag X0 Y0 X1 Y1 --ms 300;--frametakes screenshot pixels, and--fingers 2is ScummVM's right click.Touch as the mouse in Dark Forces
Tab5Emu::touch_pointer(skip_gamepad)andscreen_to_frame()give a game a pointer that can skip the touch gamepad's zones.Tab5Emu::frame_to_screen()is the inverse mapping.feat/touch-mouse(6ef6cb8) uses them.Testing
Tried on the Tab5 with emulink:
emulink tapon a game in the list selects it, and a tap on Play launches it.emulink touch --frame 270 176moves the cursor onto Begin Mission and clicks it. The mission briefing's OK works the same way.emulink dragin the middle of the screen turns (horizontal drag) and pitches (vertical drag); a quickemulink tapfires.touchpad_data().🤖 Generated with Claude Code
https://claude.ai/code/session_01SFCMzomCZ5wRHJN4sxwkvY